<HTML>
<HEAD>
<link rel=stylesheet type="text/css" href="styles.css">
<TITLE>Simkin for MIDP</TITLE>
</HEAD>
<BODY>

<H1>
Simkin for MIDP</H1>
<hr>
<p>
Simkin can be used on wireless devices which support the Java <a href="http://java.sun.com/products/midp" target="_blank">Mobile Information Device Profile (MIDP)</a> runtime environment.
<p>Running in this environment affects Simkin in a few ways:
<ul>
<li>There is no support for reflection - applications must therefore expose any methods to scripts via the <a href="api/simkin/Executable.html"><code>Executable</code></a> interface</li>
<li>There is no support for floating point numbers - scripts which contain floating point values will throw parser exceptions</li>
<li>Various classes such as <code>StringReader</code> and <code>StringTokenizer</code> are not supported - Simkin provides its own versions of these</li>
</ul>
<p>
The current version of Simkin for MIDP is provided with XML classes only (i.e. the <code>TreeNode</code> classes are not included). 
<p>Simkin uses the lightweight Open Source XML parser and DOM classes <a href="http://kxml.enhydra.org" target="_blank">KXML version 1.x</a>. You should obtain these directly from the KXML site.
<p>Most of the code in Simkin for MIDP is the same as used in the standard Java build. Additional classes are stored in the <code>simkin/for_j2me</code> and <code>simkin/kxml</code> directories.
<p>We have used an <a href="http://ant.apache.org" target="_blank">ANT</a> build script, along with extra facilities from the <a href="http://antenna.sourceforge.net/" target="_blank">Antenna</a> ANT extension libraries to construct the final source code for the MIDP version. 
<p>The distribution includes a built version of the current Simkin for MIDP in <code>SimkinMIDP.jar</code> if you don't want to build it yourself.
<p>We have also added an example showing Simkin for MIDP.
<p>The example is in the <code>simkin/examples/helloworld_midp</code> directory. It shows a simple MIDlet which loads an XML document containing script within a String, and executes the <code>main</code> method. The distribution includes <code>HelloWorld.jar</code> and <code>HelloWorld.jad</code> which are built-versions of this example.
</body>
</html>